clarify destination rule docs#2428
Conversation
Signed-off-by: Rama Chavali <rama.rao@salesforce.com>
| // Settings applicable to HTTP1.1/HTTP2/GRPC connections. | ||
| message HTTPSettings { | ||
| // Maximum number of pending HTTP requests to a destination. Default 2^32-1. | ||
| // Please note that this is applicable to both HTTP1.1/ and HTTP2. |
There was a problem hiding this comment.
HTTP/1.1 instead of HTTP1.1/ or leave the / out entirely as it's not in HTTP2.
Signed-off-by: Rama Chavali <rama.rao@salesforce.com>
|
|
||
| // Maximum number of requests to a backend. Default 2^32-1. | ||
| // Please note that this is applicable to both HTTP/1.1 and HTTP2. | ||
| int32 http2_max_requests = 2; |
There was a problem hiding this comment.
so is it identical to http1_max_pending_requests then
There was a problem hiding this comment.
It is not exactly same. http2_max_requests is how many concurrent active requests can be there. max_pending_requests is how many requests can be in pending queue waiting for connection.
Specifically for pending requests,
"For HTTP/2 connections, if max concurrent streams and max requests per connection are not configured, all requests will be multiplexed over the same connection so this circuit breaker will only be hit when no connection is already established"
So there is subtle difference on how http2 protocol options are setup.
There was a problem hiding this comment.
Should we clarify this difference in our api comments?
There was a problem hiding this comment.
yeah. good point. Let me update it.
There was a problem hiding this comment.
updated the docs. Defaults are also incorrect. Fixed them
Signed-off-by: Rama Chavali <rama.rao@salesforce.com>
|
@howardjohn can you PTAL when you get chance? |
…pplied to certain HTTP version The circuit-breaker connection pool settings `MaxRequests`and `MaxPendingRequests` apply to HTTP/1.1 as well as HTTP/2 since [1] and [2]. This was actually changed in the Istio docs via [3], but these source code comments were left, potentially causing confusion. [1] envoyproxy/envoy#9215 [2] envoyproxy/envoy#9668 [3] istio/api#2428 Signed-off-by: Christian Rohmann <christian.rohmann@inovex.de>
…pplying to particular HTTP version The circuit-breaker connection pool settings `MaxRequests`and `MaxPendingRequests` apply to HTTP/1.1 as well as HTTP/2 since [1] and [2]. This was actually changed in the Istio docs via [3], but these source code comments were left, potentially causing confusion. [1] envoyproxy/envoy#9215 [2] envoyproxy/envoy#9668 [3] istio/api#2428 Signed-off-by: Christian Rohmann <christian.rohmann@inovex.de>
…pplying to particular HTTP version (#57705) The circuit-breaker connection pool settings `MaxRequests`and `MaxPendingRequests` apply to HTTP/1.1 as well as HTTP/2 since [1] and [2]. This was actually changed in the Istio docs via [3], but these source code comments were left, potentially causing confusion. [1] envoyproxy/envoy#9215 [2] envoyproxy/envoy#9668 [3] istio/api#2428 Signed-off-by: Christian Rohmann <christian.rohmann@inovex.de>
Clarify Destination Rule docs that Max Pending Requests/ Max Requests apply to both Http1 and Http2
See istio/istio#31548 and envoyproxy/envoy#9668 (See version history and doc updates)